home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / sent112c.arc / SENTINEL.DOC < prev    next >
Encoding:
Text File  |  1991-06-22  |  5.6 KB  |  131 lines
  1. ------------------------------------------------------------------------
  2.                              S E N T I N E L
  3.  
  4.                        Message Area Freshness Tester
  5.                           V e r s i o n   1 . 1 2 c
  6.  
  7.                  Written by Bill Auclair  Opus 1:141/545.0
  8.                Copyright (C) 1990,1991 by XanSoft Development
  9.                             ALL RIGHTS RESERVED
  10. ------------------------------------------------------------------------
  11.  
  12.  
  13.         OFFICIAL DISCLAIMER:  There are no guarantees provided with
  14.         this utility.  The author shall not be held liable for
  15.         the function or failure to function of this software, or for
  16.         any damages arising from its use or abuse.  Now, with that
  17.         said, on to the good stuff....
  18.  
  19.         SENTINEL is a BBS utility I put together after experiencing
  20.         various frustrating problems with echomail delivery.
  21.         I realized I had no reliable, "at a glance" indicator of
  22.         the activity (or inactivity) of my 60+ echomail/message areas.
  23.         I quickly resolved to change this situation.....
  24.  
  25.         SENTINEL can be run from DOS or from within a batch file.  When
  26.         invoked, the program will locate and parse any echomail control
  27.         file in which a subdirectory callout is followed by an echo tag,
  28.         by specifying the name of the ctl file after the <-c> switch.
  29.         If no echomail control file is specified, the program attempts
  30.         to find AREAS.BBS in the current directory.  After the echomail
  31.         control file is processed, SENTINEL searches each echomail
  32.         message directory, locating the highest-numbered Fido-style
  33.         message and reading its SENT date.  This date is then converted
  34.         to a pseudo-Julian value, and compared with a similar Julian
  35.         value calculated for the current date, as obtained from the
  36.         system clock.  If the difference between these two values
  37.         is greater than or equal to the <-n> integer value specified
  38.         on the command line, the echomail area is flagged for inclusion
  39.         in the generated Freshness Report.
  40.  
  41.         Beginning with SENTINEL versions 1.11a and up, message area
  42.         freshness monitoring in areas defined as "pass-thru" is now
  43.         possible.  If SENTINEL cannot find *.MSG files in a pass-thru
  44.         area, it will attempt to find and obtain a datestamp from the
  45.         dupe-checking file (KILLDUPE.DAT for Opus systems, QDUPES.DAT
  46.         for systems running QMail, etc.), and will use this datestamp
  47.         information as a basis for a freshness report on that area.
  48.  
  49.         In this "indirect" manner, echomail area inactivity can be
  50.         selectively monitored, and corrective action taken when needed,
  51.         to end dreaded (and all-too-frequent!) echomail "droughts".
  52.  
  53.         Beginning with versions 1.11b and up, SENTINEL now parses the
  54.         echomail control file to obtain an echo's inbound feed (i.e., the
  55.         first net/node listed after the echo tag), and displays this
  56.         information in the body of the report.  Areas defined in the
  57.         control file but having no net/node information associated with them
  58.         are flagged as <LOCAL>.
  59.  
  60.         The Freshness Report defaults to the screen, but can also be
  61.         echoed to a text file by using the DOS redirection (>) symbol.
  62.  
  63.         SENTINEL versions 1.11a and up accept the following 3 command line
  64.         switches, specified in any order:
  65.  
  66.  
  67.         <-c>  Full path, filename and extension of echomail ctl file.
  68.  
  69.         <-n>  Minimum number of inactive days to report on.
  70.  
  71.         <-d>  Name of dupe-checking file used on your system.  This file
  72.               is placed in each message subdirectory, including areas
  73.               defined as "pass-thru".
  74.  
  75.  
  76.  
  77.         Do NOT place spaces between command-line switches and their
  78.         associated parameters!
  79.  
  80.  
  81.  
  82.         EXAMPLE:
  83.  
  84.         SENTINEL -cC:\BINKLEY\AREAS.BBS -n14 -dKILLDUPE.DAT > C:\OPUS\SENTLOG.BBS
  85.  
  86.         specifies the AREAS.BBS echomail control file in C:\BINKLEY,
  87.         reporting on highest-numbered messages with a SENT date greater
  88.         than or equal to 14 days earlier than the current date, using the
  89.         dupe-checking file KILLDUPE.DAT to monitor activity in pass-thru
  90.         areas, and echoing screen output to the log file SENTLOG.BBS in
  91.         subdirectory C:\OPUS.
  92.  
  93.         A "help screen" can be generated by typing SENTINEL -H.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.         REVISION HISTORY:
  100.  
  101.  
  102.  11/21/89  v1.10:    First public release.
  103.  
  104.  12/11/90  v1.11a:   Added code so that SENTINEL now reports freshness of
  105.                      message areas defined as "pass-thru".  Revised logging
  106.                      function to utilize DOS redirection functions.
  107.  
  108.  12/18/90  v1.12:    Added inbound feed (net/node) information to report
  109.                      listings for each echomail area.
  110.  
  111.  1/21/91  v1.12a:    Fixed variable initialization problem that was causing
  112.                      SENTINEL to lock up when processing echomail ctl files
  113.                      with more than 128 characters per line.  New per-line
  114.                      character limit is 255.
  115.  
  116.  6/22/91  v1.12c:    Maintenance release, fixes some minor bugs.  Streamlined
  117.                      and reorganized program flow for faster execution.
  118.  
  119.  
  120.         Please do a harried programmer a favor!  If you find any
  121.         "bugs", "glitches" or other errors in this software, REPORT
  122.         THEM!  The author can be reached at FidoNet node # 1:141/545.
  123.  
  124.  
  125.         Thanks.  Hope you find this utility useful....
  126.  
  127.  
  128.         Bill Auclair
  129.         6/22/91
  130.  
  131.